home *** CD-ROM | disk | FTP | other *** search
/ Sprite 1984 - 1993 / Sprite 1984 - 1993.iso / man / lib.fmt / tcl / Concat.man < prev    next >
Text File  |  1992-02-14  |  2KB  |  67 lines
  1.  
  2.  
  3.  
  4. Tcl_Concat            C Library Procedures             Tcl_Concat
  5.  
  6.  
  7.  
  8. _________________________________________________________________
  9.  
  10. NNAAMMEE
  11.      Tcl_Concat - concatenate a collection of strings
  12.  
  13. SSYYNNOOPPSSIISS
  14.      ##iinncclluuddee <<ttccll..hh>>
  15.  
  16.      char *
  17.      TTccll__CCoonnccaatt(_a_r_g_c, _a_r_g_v)
  18.  
  19. AARRGGUUMMEENNTTSS
  20.      int_a_r_g_c(in)
  21.      Number of strings.
  22.  
  23.      char*_a_r_g_v[](in)
  24.      Array of strings to concatenate.  Must have _a_r_g_c entries.
  25. _________________________________________________________________
  26.  
  27.  
  28. DDEESSCCRRIIPPTTIIOONN
  29.      TTccll__CCoonnccaatt is a utility procedure used by several of the Tcl
  30.      commands.   Given  a  collection of strings, it concatenates
  31.      them together  into  a  single  string,  with  the  original
  32.      strings  separated  by  spaces.  This procedure behaves dif-
  33.      ferently than TTccll__MMeerrggee, in that the  arguments  are  simply
  34.      concatenated: no effort is made to ensure proper list struc-
  35.      ture.  However, in most common usage the arguments will  all  |
  36.      be  proper  lists  themselves;   if  this  is true, then the  |
  37.      result will also have proper list structure.                  |
  38.  
  39.      TTccll__CCoonnccaatt eliminates leading and trailing white space as it  |
  40.      copies  strings  from  aarrggvv to the result.  If an element of  |
  41.      aarrggvv consists of nothing but white space, then  that  string  |
  42.      is  ignored entirely.  This white-space removal was added to  |
  43.      make the output of the ccoonnccaatt command cleaner-looking.
  44.  
  45.      The result string is dynamically allocated  using  mmaalllloocc(());
  46.      the  caller  must  eventually  release  the space by calling
  47.      ffrreeee(()).
  48.  
  49.  
  50. KKEEYYWWOORRDDSS
  51.      concatenate, strings
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.  
  62.  
  63. Sprite v1.0                                                     1
  64.  
  65.  
  66.  
  67.